home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / libblas / dot.z / dot
Encoding:
Text File  |  2002-10-03  |  3.9 KB  |  107 lines
  1. DOT(3F)                                               Last changed: 11-2-98
  2.  
  3.  
  4. NNAAMMEE
  5.      SSDDOOTT, DDDDOOTT, CCDDOOTTCC, ZZDDOOTTCC, CCDDOOTTUU, ZZDDOOTTUU - Computes a dot product (inner
  6.      product) of two real or complex vectors
  7.  
  8. SSYYNNOOPPSSIISS
  9.      Real
  10.  
  11.         _d_o_t == SSDDOOTT ((_n,, _x,, _i_n_c_x,, _y,, _i_n_c_y))
  12.  
  13.      Double precision
  14.  
  15.         _d_o_t == DDDDOOTT ((_n,, _x,, _i_n_c_x,, _y,, _i_n_c_y))
  16.  
  17.      Complex
  18.  
  19.         _d_o_t == CCDDOOTTCC ((_n,, _x,, _i_n_c_x,, _y,,
  20.  
  21.         _d_o_t == CCDDOOTTUU ((_n,, _x,, _i_n_c_x,, _y,, _i_n_c_y))
  22.  
  23.      Double complex
  24.  
  25.         _d_o_t == ZZDDOOTTCC ((_n,, _x,, _i_n_c_x,, _y,, _i_n_c_y))
  26.  
  27.         _d_o_t == ZZDDOOTTUU ((_n,, _x,, _i_n_c_x,, _y,, _i_n_c_y))
  28.  
  29. IIMMPPLLEEMMEENNTTAATTIIOONN
  30.      IRIX systems
  31.  
  32. DDEESSCCRRIIPPTTIIOONN
  33.      SSDDOOTT/DDDDOOTT computes a dot product of two real vectors (_l  real inner
  34.      product).                                              _2
  35.  
  36.      CCDDOOTTCC/ZZDDOOTTCC computes a dot product of the conjugate of a complex
  37.      vector and another complex vector (_l  complex inner product).
  38.                                          _2
  39.      CCDDOOTTUU/ZZDDOOTTUU computes a dot product of two complex vectors.
  40.  
  41.      SSDDOOTT/DDDDOOTT and CCDDOOTTUU/ZZDDOOTTUU perform the following vector operation:
  42.  
  43.                   T      n
  44.           dot <- x  y = Sum x  y
  45.                         i=1  i  i
  46.                                                      _T
  47.      where _x and _y are real or complex vectors, and _x  is the transpose of
  48.      _x.
  49.  
  50.      CCDDOOTTCC/ZZDDOOTTCC performs the following vector operation:
  51.  
  52.                   H      n   _
  53.           dot <- x  y = Sum  x  y
  54.                         i=1   i  i
  55.                                              _H
  56.      where _x and _y are complex vectors, and _x  is the conjugate transpose
  57.      of _x.
  58.  
  59.      If _n <= 0, _d_o_t is set to 0.
  60.  
  61.      These functions have the following arguments:
  62.  
  63.      _d_o_t   Result (dot product).  (output)
  64.            SSDDOOTT: Real result.
  65.            DDDDOOTT: Double precision result.
  66.            CCDDOOTTCC, CCDDOOTTUU: Complex result.
  67.            ZZDDOOTTCC, ZZDDOOTTUU: Double complex result.
  68.  
  69.      _n     Integer.  (input)
  70.            Number of elements in each vector.
  71.  
  72.      _x     Array of dimension (_n-1) * |_i_n_c_x| + 1.  (input)
  73.            SSDDOOTT: Real array.
  74.            DDDDOOTT: Double precision array.
  75.            CCDDOOTTCC, CCDDOOTTUU: Complex array.
  76.            ZZDDOOTTCC, CCDDOOTTUU: Double complex array.
  77.            Array _x contains the first vector operand.
  78.  
  79.      _i_n_c_x  Integer.  (input)
  80.            Increment between elements of _x.  If _i_n_c_x = 0, the results will
  81.            be unpredictable.
  82.  
  83.      _y     Array of dimension (_n-1) * |_i_n_c_y| + 1.  (input)
  84.            SSDDOOTT: Real array.
  85.            DDDDOOTT: Double precision array.
  86.            CCDDOOTTCC, CCDDOOTTUU: Complex array.
  87.            ZZDDOOTTCC, ZZDDOOTTUU: Double complex array.
  88.            Array _y contains the second vector operand.
  89.  
  90.      _i_n_c_y  Integer.  (input)
  91.            Increment between elements of _y.  If _i_n_c_y = 0, the results will
  92.            be unpredictable.
  93.  
  94. NNOOTTEESS
  95.      These routines are Level 1 Basic Linear Algebra Subprograms (Level 1
  96.      BLAS).
  97.  
  98.      When working backward (_i_n_c_x < 0 or _i_n_c_y < 0), each routine starts at
  99.      the end of the vector and moves backward, as follows:
  100.  
  101.           _x(1-_i_n_c_x * (_n-1)), _x(1-_i_n_c_x * (_n-2)), ..., _x(1)
  102.  
  103.           _y(1-_i_n_c_y * (_n-1)), _y(1-_i_n_c_y * (_n-2)), ..., _y(1)
  104.  
  105. SSEEEE AALLSSOO
  106.      This man page is available only online.
  107.